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Introduction 



Quick Reference Guide 



SAS2Flash Utility 



This document explains how to use the SAS2Flash Utility and all of its commands. 



1.0 Introduction The SAS2Flash Utility enables you to flash the Fusion-MPr" firmware and the 

OptionROM image on LSI SAS2 controllers and host bus adapters (HBAs). You can also 

use this powerful utility to perform tasks such as displaying HBA information, 
programming SAS addresses, testing BIOS versions, and displaying the contents of the 
Ethernet page. 

This document is intended for the following audiences: 

■ Engineers who work in manufacturing environments 

■ System engineers, test engineers, and firmware engineers 

■ OEMs, LSI employees, and end users 

This document provides the command line option syntax and functionality of all 
SAS2Flash Utility commands. It also explains a few limitations of different platform 
builds of the SAS2Flash Utility (see Section 7.0, Operating System Limitations, on 
page 22). 



CAUTION: Before you use the SAS2Flash Utility commands, be sure you understand 
how they operate. Some of the commands, such as the one that erases regions of the 
controller, are potentially destructive if they are not used correctly. 



2.0 Hardware and Software The SAS2Flash Utility is compatible with the following hardware and software. 
Compatibility 



2.1 LSI SAS2 Controllers and HBAs The SAS2Flash Utility supports all LSI SAS2 Fusion-MPT architecture controllers and the 

HBAs based on these controllers, implemented to message passing interface (MPI) v2.0. 
Currently, the SAS2Flash Utility supports the following controller models: 

■ LSISAS2004 

■ LSISAS2008 

■ LSISAS2108 

■ LSISAS2116 

■ LSISAS2208 

■ LSISAS2308 

MPI defines the host interface used by all LSI common architecture chipsets and allows 
the quick development of host-based drivers and applications. 
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2.2 Hardware Platforms The SAS2Flash Utility is compatible with the following hardware platforms: 

■ Intel" EM64T/Advanced Micro Devices' AMD64' 

■ Intel IA-64 

■ Intel x86 (1386/1486 processor family) or compatible 

■ Sun" SPARC' V9 

■ IBM* PowerPC' 64 

2.3 Operating Systems The SAS2Flash Utility is compatible with the following operating systems: 

■ Red Hat' Enterprise Linux' (RHEL) 4, RHEL 5 

■ SUSE' Linux Enterprise Server (SLES) 9, and SLES 1 0 

■ Microsoft' MS-DOS* 6.22 

■ FreeDOS" 1 .0 

■ Windows' XP Windows 2000, Windows Vista*, Windows Server* 2003, and 
Windows Server 2008 

■ WinPE 1 .X (Server 2003/XP), WinPE 2.0 (Vista), WinPE 2.1 (Server 2008) 

■ Unified Extensible Firmware Interface (UEFI) version 2.1 

■ Sun OpenSolaris " build 1 1 3 and later 

■ FreeBSD* 7.3 

2.4 OS Architecture The SAS2Flash Utility is compatible with the following operating system architectures: 

■ Windows/WinPE - x86, x64 (AMD64), IA64 

■ UEFI - UEFI Byte Code (UEBC) 

■ Linux* - x86 compatible, PPC64 

■ Solaris x86 or compatible, SPARC 

■ FreeBSD - x86 or compatible 

2.5 Other Software The SAS2Flash Utility is compatible with the following software and firmware: 

■ PCI firmware -PCI 2.x, PCI 3.0 

■ MPT firmware - MPI 2.0.x 

■ DOS - Support for BIOS32 services in System BIOS (for DOS version) 

■ UEFI firmware 2.1 (for UEFI version) 

■ Windows driver v2.00.00.1 9 or later (for Windows version) 

■ Linux driver vOO.255.04 (2.6 kernel) or later (for Linux version) 

■ Solaris driver vOO.00.1 5.00 or later (for Solaris version) 

■ FreeBSD driver version 2.00.00.01 or later (for FreeBSD version) 



NOTE: The SAS2Flash Utility requires an amount of memory equal to the sum of the 
flash memory size of the SAS2 controller, plus 0.5 MB. For most controllers, the 
requirement is 2.5 MB. 



NOTE: The SAS2Flash Utility supports the MPI V2.0.X firmware interface. It does not 
support any earlier versions of MPI. 
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Use the following commands to start the SAS2Flash Utility: 

■ D0S:sas2flsh 

■ Other operating systems: sas2 flash 



The SAS2Flash Utility supports the following modes of operation. 

■ Command Line Mode 

Most command line parameters place the SAS2Flash Utility in command line mode. 
This mode receives most of its input from the command line parameters. It attempts 
to run without prompting you for input, unless it needs input to complete a 
command. 

If you invoke the SAS2Flash Utility in silent mode (see Section 5.4.29, Silent Switch, 
on page 1 9), the utility does not prompt you for input. If it needs input, it logs an 
error that indicates the required input. 

■ User Interface Mode 

The SAS2Flash Utility uses a standard 80x25 text mode interface to give you an 
overview of an operation. The user interface contains advanced mode and standard 
mode, which you select using the command line. 

■ Command File Mode 

The SAS2Flash Utility supports a command file, because command lines can be very 
long and many operating systems place a limit on their length. A command file, 
which is an ASCII text file, contains the parameters that you would otherwise enter 
on the command line. When you provide a command file, the utility does not use 
other command line parameters. 



This section describes the commands that the SAS2Flash Utility supports. 

The command line begins with sas2 flash (or sas2f Ish in DOS), followed by one 
or more switches that are separated by spaces, followed by a filename or other 
arguments required by a switch. 

Example: 

sas2flash -o -f filename 

The first switch, -o, does not take a parameter. The second option, -f, takes a filename 
as a parameter. Spaces are required because there can be multiple command line 
options that start with the same letters. 
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The structure of the command line determines the order in which the SAS2Flash Utility 
runs the commands. To determine the order of the commands, the utility follows this 
two-step process. 

1 . All commands have a preassigned order level based on the following six categories. 
The SAS2Flash Utility sorts the options according to this order and runs the 
commands in that sequence. 



a. 


Order 0 


- Flags 


b. 


Order 1- 


- All controller commands 


c. 


Order2 


- Choose adapter 


d. 


Orders 


- BIOS and firmware flash 


e. 


Order 4 


- Program and test 


f 


Order 5 


- Display and list 



2. Within each order level, the SAS2Flash Utility runs the commands in the sequence 
in which they appear on the command line, from left to right, with the following 
exceptions. 

— Order 0 commands are reserved for the command file, which is run separately 
and cannot be run simultaneously with other commands. 

— Order 2 commands (for example, the command to flash firmware on controllers), 
cannot run simultaneously with other commands. After running Order 2 
commands, the SAS2Flash Utility exits and reports all other commands as not 
run. If there are no Order 2 commands, the SAS2Flash Utility proceeds to Order 3 
and so on, and then runs all commands. 

Follow these syntax rules for constructing command lines: 

■ If a command line option takes a value, use a space to separate the option and the 
value. 

■ File names and paths must conform to the syntax rules of the operating system. If 
the operating system allows spaces in file names, enclose the file name and the 
path within double quotation marks. 

■ The SAS2Flash Utility does not support duplicate command line options. If you use 
duplicate options, the command fails and the utility returns an error message. 

■ Certain commands support duplicate options, which are mentioned in those 
command descriptions. 
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5.4 Command Line Parameters The following table lists the command line parameters of the SAS2Flash Utility. The 

sections following the table explain the syntax and functionality for each command. 



Table 1 : Command Line Parameters 











Argument 




Advanced Command Mode 
Switch 


-0 


1 


— 


None 


Enable advanced command mode. 


BIOS All 


-biosall 


7 


N 


filenamel 


Try to flash all controllers with BIOS in filenamel. 


BIOS Update 


-b 


4 


Y/N 


filenamel 


Flash a BIOS from filenamel. 


Controller Address Flag 


-cpci 


2 


N 


num1:num2: 
num3:num4 


Select a controller by PCI bus:device:function, or 
optionally by bus:device:function:segment. 


Controller Number Flag 


-c 


2 


N 


numi 


Select a controller by numi. 


Command File Directive 


@ 


0 


N 


filenamel 


Use command file from filenamel. 


Debug Switch 


-debug 


1 


N 


None 


Turn on debug output. 


Display Version 


-ver 


8 


N 


None 


Show the version of the SAS2Flash Utility. 


Download Complete Flash 


-dflash 


3 


Y 


filenamel 
filename2 


Download the complete flash image on the controller. 
Filenamel is the valid complete flash image that 
needs to be flashed on the controller. Filenamel is a 
valid firmware file that the utility uses to flash 
filenamel on the controller. 


Erase 


-e 


4 


Y 


numi 


Erase a region specified by numi. 


Firmware All 


-fwall 


7 


N 


filenamel 


Try to flash all controllers with firmware in filenamel. 


Firmware Update 


-f 


3 


Y/N 


filenamel 


Flash firmware from filenamel. 


Help 


-?or-h 


1 


N 


None 


Display command line options help information. 


List 


-list 


6 


N 


None 


List information about the selected adapter. 


List All 


-listall 


6 


N 


None 


t * ± ' r a* 1 all 1 < 

List information about all adapters. 


List SAS Address 


-listsasadd 


6 


Y 


None 


Show the SAS address of the selected controller. 


Log File 


-1 


1 


N 


filenamel 


Specifies logging output to the file in filenamel. 


Program Assembly 


-assem 


5 


Y 


stringl 


Program the selected controller with an assembly 
value oi stringl. 


Program Board Tracer 


-tracer 


5 


Y 


stringl 


Program the selected controller with a board tracer of 
stringl. 


Program Ethernet Information 


-eth 


5 


Y 


filenamel 


Program the Ethernet page of the selected controller 
with the parameters in filenamel. 


Program SAS Address 


-sasadd 


5 


Y 


Numi 


Program the selected controller with SAS address 
from numi. 


Program SAS Address High 


-sasaddhi 


5 


Y 


Numi 


Use num 1 for the high 28 bits of the SAS address. You 
will be prompted for the remainder. 


Program VPD 


-vpd 


5 


Y 


filenamel 


Program the selected controller with the vital product 
data (VPD) file in filenamel. 


Reset 


-reset 


3 


Y 


None 


Perform a reset on the selected controller. 


Reset All 


-resetall 


7 


Y 


None 


Reset all controllers. 


Scan Character Flag 


-scanchar 


5 


Y 


stringl 


Look for character in stringl as the first character 
when scanning a SAS address. 
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Table 1 : Command Line Parameters (Continued) 







BS9 


^RWjl||TtU«| 


^^^^^^ 




Show Ethernet Information 


-showeth 


5 


Y 


None 


Show the contents of the Ethernet page. 


Show VPD 


-showvpd 


5 


Y 


None 


Show the VPD file. 


Silent Switch 


-s 


1 


N 


None 


Enable silent mode. 


Test BIOS Version 




4 


Y 


string 1 


Test RIOS version anainst <itrinnl In formp^t 
major.minor.unit.dev. 


Test Firmware Version 


-testfw 


4 


Y 


stringl 


Test firmware version against string 1 in format 
major.minor.unit.dev. 


Test Link State 


-testis 


4 


Y 


num1:num2 


Test PHY numi on selected controller for link state 
snerlfleH in ntimy 


Test Link State All 


-testlsall 


4 


Y 


None 


Show link state on all PHYs. 


Test Product ID 


-testprodid 


4 


Y 


Numi 


Test the selected controller's product ID against num 7. 


Test Subsystem Identification 


-testssid 


6 


Y 


num1:num2 


Test the selected controller's SSVID against num 1 and 
SSDID against num2. 


Upload BIOS 


-ubios 


5 


N 


filenamel 


Upload the boot services (BIOS) to filenamel. 


Upload Firmware 


-ufirmware 


5 


N 


filenamel 


Upload the firmware Image to filenamel. 


Upload Firmware Backup 


-ufwbackup 


5 


Y 


filenamel 


Upload the firmware backup location to filenamel. 


Upload Flash Image 


-uflash 


5 


Y 


filenamel 


Upload the entire flash Image to filenamel. 


Upload NVDATA 


-unvdata 


5 


Y 


filenamel 


Upload the NVDATA to filenamel. 



The advanced command mode switch enables the SAS2Flash Utility commands that 
have a Vin the Advanced Command column in the preceding table. If you do not use 
the -o advanced mode switch preceding these commands on the command line, the 
SAS2Flash Utility rejects the commands as unrecognized. 

Advanced commands are intended for system engineers, test engineers, firmware 
engineers, and engineers who work in a manufacturing environment. LSI advises that 
you use advanced commands with great caution. 

Syntax: 

sas2flash -o 

5.4.2 BIOS All Use the BIOS All command to update the BIOS on all supported controllers. The 

command only allows updates to a later version of the BIOS image. It does not allow 
downgrading in a version. The SAS2Flash Utility performs the following steps during 
the upgrade process: 

1. Open the specified file. 

2. Determine if the file is a valid BIOS image. 

The image validity check includes a basic check for a valid PCI ROM header and a 
checksum of the core BIOS image. 



5.4.1 Advanced Command 
Mode Switch 
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3. Perform a series of safety checks. 

The safety checks ensure that the provided BIOS supports the specified controller 
family within the limits of the ability of the program. If any of the safety checks fail, 
the utility skips the controller and continues the process with the next supported 
controller. 

4. If the BIOS download operation succeeds, upload the BIOS image and compare it to 
the image that was downloaded. If the comparison fails, log a failure. 

5. If the BIOS image downloads successfully, attempt to update the BIOS version in 
VPD. 

The utility checks the VPD information in Manufacturing Page 1 to determine if 
valid VPD data is available. If so, and if the VPD data has a keyword to hold a BIOS 
version of the appropriate type (x86 BIOS, FCODE, or UEFI BSD), the utility updates 
the version string with the version of the newly downloaded BIOS image. 

Syntax: 

sas2flash -biosall mptsas.rom 

5.4.3 BIOS Update Use the BIOS Update command to download a new x86 BIOS image, FCODE, or UEFI 

boot services driver (BSD). The SAS2Flash Utility performs the following steps during 
the upgrade process: 

1. Open the specified file. 

2. Determine if the file is a valid BIOS image. 

The image validity check includes a basic checkfor a valid PCI ROM header and a 
checksum of the core BIOS image. 

3. Perform a series of safety checks on the controller. 

The safety checks ensure that the provided BIOS supports the specified controller 
family within the limits of the ability of the program. If any of the safety checks fails, 
the utility generates a failure report. 

4. Update the controller if the file passes all of the checks. 

The BIOS update command supports the duplicate command line option, allowing 
you to flash x86 BIOS, FCODE, and UEFI BSD in a single command line invocation. 

The SAS2Flash Utility performs a read, modify, and write operation on the BIOS region 
of the flash. The utility reads the BIOS region, finds the type of image being updated 
(x86 BIOS, FCODE, or UEFI BSD) in the block, and replaces it with the new image. The 
utility writes the modified image to the boot region in the flash. 

If the BIOS image downloads successfully, the SAS2Flash Utility uploads the BIOS image 
and compares it with the downloaded image. If the comparison fails, it logs a failure. 

Syntax: 

sas2flash -b mptsas.rom 
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5.4.4 Controller Address Flag Use the Controller Address flag to indicate the PCI address of the controller on which 

you want the SAS2Flash Utility to operate. The address is specified as the bus, device, 
and function number, based on the current mapping of the PCI bus. Multidomain PCI 
addressing is supported if the operating system supports it. Multidomain PCI 
addressing uses a PCI segment, bus, device, and function number, as shown in the 
second of the following syntax examples. 

Syntax: 

sas2flash -cpci 5:3:0 
sas2flash -cpci 1:3:2:0 

5.4.5 Controller Number Flag Use the Controller Number flag to make the SAS2Flash Utility operate on a specified 

controller. The controller number, which is the index of the controller, is arbitrary 
because it is based on the order in which the controllers in the system were discovered. 
The number is a 1 -based index, so the number 1 is assigned to the first controller that is 
found. Specify the controller number as a hexadecimal value. 

Syntax: 

sas2flash -c 1 



5.4.6 Command File Directive Use the Command File directive to specify a command file for execution. When you 

specify a command file option on the command line, in any order, the SAS2Flash Utility 
ignores all other command line parameters. Carriage return and line feed characters in 
the command file are ignored. 

Syntax: 

sas2flash ©command. txt 

The command file contains command line items, such as the ones shown in the 
following example: 

-c 2 

-b mptsas2 . rom 
-f irl068.fw 

-reset 



5.4.7 Debug Switch Use the Debug switch to enable debug data in the tool that is output to the screen, 

along with normal output messages. Alternatively, you can direct the debug output to 
a log file. The debug flag is helpful during the debugging process and can be used 
together with one or more commands. 

Syntax: 

sas2flash -debug 

5.4.8 Display Version Use the Display Version command to display the LSI banner and the SAS2Flash Utility 

version. 

Syntax: 

sas2flash -ver 
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5.4.9 Download Complete Use the Download Complete Flash command to download the complete flash image 

^^^^^ on the controller. The command takes two files as arguments. 

■ Filename! is the valid complete flash image that must be flashed on the controller. 

■ Filename! is a valid firmware file that the SAS2Flash Utility must use to flash 
filenamel on the controller. 

The SAS2Flash Utility performs minimum validation on the flash image file. The utility 
opens the specified firmware file (FilenameZ), verifies that it is a valid firmware image, 
performs a series of safety checks, and uses the file to flash the controller with the flash 
image. 

The SAS2Flash Utility completes the following steps to validate the firmware file: 

1. Open the firmware file. 

2. Check for a valid firmware header signature, as defined by the Fusion-MPT2.0MPI 
Specification. 

3. Check for zero checksum on the entire firmware image. 

4. Determine if the firmware image is valid for the controller being flashed. 

The utility checks for support in the firmware image for the PCI Device and Revision 
ID. It checks the PCI Device and Revision ID from the controller's PCI Config Space 
with the list of devices supported in the Supported Devices Firmware Extended 
Image Data. 

5. Check for a valid NVDATA Extended Image in the firmware image. 

6. Check for NVDATA compatibility. 

The SAS2Flash Utility checks the signature of the CFGI Directory Header and 
CFGI Product ID structure for validity on the firmware image from the file and on the 
firmware image from the controller (if the controller already has firmware on it). If 
this check passes and if the controller already has firmware on it, the utility checks 
the NVDATA Product ID and NVDATA Vendor ID from NVDATA in the file with the 
NVDATA from the controller. 

7. Verify that the firmware image has a valid INIT image. 

8. Verify that the firmware image has a valid BOOTLOADER image. 

If any of the validation checks fail, the SAS2Flash Utility sends a failure message to the 
screen and logs it to the log file. 

When the Flash image is successfully downloaded, the SAS2Flash Utility tries to update 
the firmware version in VPD. It checks the VPD information on Manufacturing Page 1 to 
determine if valid VPD data is available. If so, and if the VPD data has a keyword to hold 
the firmware version, the utility updates the version string with the version of the newly 
downloaded firmware image. 

Syntax: 

sas2flash -o -dflash Flashlmage.bin Firmwarelmage.bin 



LSI Corporation | June 201 1 



Page 13 



Commands 



SAS2Flash Utility Quick Reference Guide 



5.4.10 Erase Use the Erase command, which is available only in the advanced command set, to erase 

an entire region, as specified by a number. 



CAUTION: Be sure you want to erase the region before using this command. You 
cannot undo an erase operation. 

Syntax: 

sas2flash -o -e 1 

The following table shows the parameters for this command and the region that each 
parameter erases. 



Table 2: Command Parameters and Regions 







1 


NVSRAM 


2 


Backup firmware 


3 


Persistent configuration pages 


4 


Manufacturing area (MPB) 


5 


Boot services 


6 


Clean flash (erase everything except manufacturing area) 


7 


Erase complete flash 


8 


MegaRAID* firmware 



5.4.11 Firmware All Use the Firmware All command to update the firmware on all supported controllers. 

This command only updates to a later version of firmware image and does not allow 
the firmware to be downgraded. The update process includes the following steps: 

1. Open the specified file. 

2. Verify that the file is a valid firmware image, and run through all supported 
controllers. 

The steps for firmware image validation and updating are listed in the description of 
the Firmware Update command. 

3. Perform a series of safety checks on each controller, and update the controller if all 
of the checks are validated. This command relies on the SAS2Flash Utility to 
determine which controllers need to be updated. Therefore, it is not possible to 
override any of the safety checks. 

4. If any safety check for a given controller fails, skip the controller and continue the 
process with the next supported controller. 

If the firmware download operation succeeds, the SAS2Flash Utility uploads the 
firmware image and compares it with the downloaded image. If the comparison fails, 
the utility erases the firmware image and the command fails. If a firmware image is 
already loaded in the flash memory, it continues to be used, and all firmware update 
operations download the new firmware image to a backup area. 
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If both the firmware download operation and the comparison of the uploaded 
firmware image with the downloaded firmware image are successful, this command 
issues an adapter reset, which automatically copies the new firmware image from the 
backup area to the running firmware location. 

When the firmware image is successfully downloaded, the SAS2Flash Utility tries to 
update the firmware version in VPD. It checks the VPD information on Manufacturing 
Page 1 to determine if valid VPD data is available. If so, and if the VPD data has a 
keyword to hold the firmware version, the utility updates the version string with the 
version of the newly downloaded firmware image. 

Syntax: 

sas2flash -fwall image. fw 

5.4.12 Firmware Update Use the Firmware Update command to download a new firmware image. This process 

includes the following operations: 

1. Open the specified file. 

2. Verify that the file is a valid firmware image, and run through all supported 
controllers. 

The firmware image validation involves the following steps: 

a. Check for a valid firmware header signature, as defined by the Fusion-MPT 2.0 
MPI Specification. 

b. Check for zero checksum on the firmware image. 

c. Determine if the firmware image is valid for the controller being flashed. 

To validate, the SAS2Flash Utility compares the PCI device and revision ID 
information from the controller's PCI configuration space and from the list of 
devices in Supported Devices Firmware Extended Image Data. 

d. Check for a valid NVDATA Extended Image in the firmware image. 

e. Check for NVDATA compatibility. Check the signature of the CFGI Directory 
Header and CFGI Product ID for validity on the firmware image from the file and 
on the firmware image from the controller (if the controller already has firmware 
on it). If the checks pass and the controller already has firmware on it, compare 
the NVDATA Product ID and NVDATA Vendor ID from the NVDATA from the file 
with the corresponding IDs from the NVDATA from the controller. 

f Verify that the firmware image has a valid INIT image. 

g. Verify that the firmware image has a valid BOOTLOADER image. 

h. Determine if NVSRAM is present before allowing Integrated Raid (IR) Firmware 
flashing. If NVSRAM is not present, do not allow IR Firmware flashing. 

i. Determine if Initiator Target firmware is present before allowing IR firmware 
flashing and vice versa. If it is present, do not allow the firmware update. 

3. Perform a series of safety checks on each controller. 

4. Display any firmware validation check failures for a given controller on the screen 
and log them to the log file. 

5. Update the controller if it passes all safety checks. 

The advanced mode version of this command offers an override if the NVDATA Vendor 
ID and the NVDATA Product ID fields from the new firmware image do not match the 
same fields in the firmware that are already flashed on the controller. 
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If the firmware download operation is successful, the SAS2Flash Utility uploads the 
firmware image and compares it with the downloaded image. If the comparison fails, 
the utility erases the image and the command fails. If a firmware image is already 
loaded in the flash memory, it continues to be used, and all firmware update operations 
download the new firmware image to a backup area. 

If both the firmware download operation and the comparison of the uploaded 
firmware image with the downloaded firmware image are successful, this command 
automatically issues an adapter reset, which copies the new firmware image from the 
backup area to the running firmware location. 

When the firmware image is successfully downloaded, the SAS2Flash Utility tries to 
update the firmware version in VPD. It checks the VPD information on Manufacturing 
Page 1 to determine if valid VPD data is available. If so, and if the VPD data has a 
keyword to hold the firmware version, the utility updates the version string with the 
version of the newly downloaded firmware image. 

Syntax: 

This command is used in both regular mode and advanced more, with the differences 
described earlier in this section. 

sas2flash -f image . fw 
sas2flash -o -f image. fw 

5.4.13 Help Use the Help command to list the command line options that the SAS2Flash Utility 

recognizes. The -o option enables advanced help and allows the display of the 
advanced option help. 

Syntax: 

sas2flash -h 
sas2flash -? 
sas2flash -o -h 
sas2flash -o -? 

5.4.14 List Use the List command to list information on the screen about the controller specified in 

the command. You also can output the information to a log file and pipe it to another 
destination. 

Syntax: 

sas2flash -list 
sas2flash -c 2 -list 

5.4.15 List All Use the List All command to list information on the screen about all controllers 

supported by the SAS2Flash Utility. You also can output the information to a log file 
and pipe it to another destination. 

Syntax: 

sas2flash -listall 
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5.4.16 List SAS Address Use the List SAS Address command to list on the screen the SAS address of the 

specified controller. You also can output the information to a log file and pipe it to 
another destination. 

Syntax: 

sas2flash -o -listsasadd 
sas2flash -c 2 -o -listsasadd 



5.4.1 7 Log File Use the Log File command to specify a file for logging output. The SAS2Flash Utility 

creates the file with the name you specify. If this file name already exists, the utility 
opens the file and deletes all its contents. 

Syntax: 

sas2flash -1 logfilename.log 



5.4.18 Program Assembly Use the Program Assembly command to program the specified controller with an 

assembly value. You must provide the complete 1 6-character assembly value, which is 
programmed directly to the controller. The value is truncated or padded with 
termination characters, as required. 



NOTE: The utility programs the Assembly number and Tracer number directly to 
Manufacturing Page 0. It programs the SAS Address directly to Manufacturing Page 5. 



Syntax: 

sas2flash -o -assem "12AB" 



5.4.19 Program Board Tracer Use the Program Board Tracer command to program the specified controller with a 

board tracer value. When you enter the 1 6-character value on the command line, the 
SAS2Flash Utility programs it to the controller. The board tracer value is truncated or 
padded with termination characters, as needed. 

Syntax: 

sas2flash -o -tracer "12AB" 



5.4.20 Program Ethernet Use the Program Ethernet Information command to program an Ethernet parameter 

Information fj|g ^-q specified controller. You specify the file on the command line. The SAS2Flash 

Utility then parses the file and programs the data to the appropriate location in 

nonvolatile storage. 



NOTE: See Section 9.0, Sample Parameter File for Program Ethernet Information 
Command, on page 24, for an example of an Ethernet parameter file. 

Syntax: 

sas2flash -o -eth ethernet_settings.txt 
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5.4.21 Program SAS Address Use the Program SAS Address command to program the specified controller with a SAS 

address. You must provide the complete SAS address, which is programmed directly to 
the controller. This command recognizes the input format of the SAS address. The 
address can optionally include the hexadecimal prefix Ox. 

Syntax: 

sas2flash -o -sasadd 50062b000000000 
sas2flash -o -sasadd 0x50062b000000000 



5.4.22 Program SAS Address Use the Program SAS Address High command to program the specified controller with 

^'9*' the first 28 bits (seven characters) of the SAS address, which are specified at the 

command line. The SAS2Flash Utility then prompts you to enter the other nine 
characters and programs the value to the controller. Use this command with a barcode 
reader. 

Syntax: 

sas2flash -o -sasaddhi 50062b0 



5.4.23 Program VPD Use the Program VPD command to program the specified controller with a VPD 

parameter file. The file name is provided on the command line. The SAS2Flash Utility 
parses the data in the file you enter on the command line and programs it to the 
appropriate location in nonvolatile storage. The utility verifies the individual field 
lengths, but it does not verify the parameter values. 



NOTE: See Section 8.0, Sample Parameter File for Program VPD Command, on page 23, 
for an example of a VPD parameter file. 



Syntax: 

sas2flash -o -vpd file.vpd 

5.4.24 Reset Use the Reset command to issue a reset to the specified controller. The command 

resets the chip hardware and reinitializes all chip information. It also performs the 
following steps: 

■ Moves a new firmware image from the firmware backup location to the current 
firmware location. 

■ Migrates the NVDATA changes. 

■ Runs the new firmware. 

Syntax: 

sas2flash -o -reset 
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5.4.25 Reset All Use the Reset All command to issue a reset to all supported controllers in the system. 

The command resets the chip hardware and reinitializes all chip information. It also 
performs the following steps: 

■ Moves a new firmware image from the firmware backup location to the current 
firmware location. 

■ Migrates the NVDATA changes. 

■ Runs the new firmware. 
Syntax: 

sas2flash -o -resetall 

5.4.26 Scan Character Flag Use the Scan Character flag to specify a scan character to look for before accepting a 

SAS address input. You typically use this command to specify the scan character that a 
barcode scanner sends to indicate the beginning of a valid string. Use the scan 
character flag only when programming a SAS address. In the command line, the flag 
must appear before the option to program the SAS address, as shown in the following 
syntax example. 

Syntax: 

sas2flash -o -scanchar " " -sasadd 50062b000000000 



5.4.27 Show Ethernet Use the Show Ethernet Information command to display the contents of the Ethernet 

Information pages for the specified controller. 

Syntax: 

sas2flash -o -showeth 



5.4.28 Show VPD Use the Show VPD command to display the contents of the VPD file for the specified 

controller. 

Syntax: 

sas2flash -o -showvpd 

5.4.29 Silent Switch Use the Silent switch to enable the silent operation mode, in which the SAS2Flash 

Utility does not solicit your feedback. The SAS2Flash Utility logs the output to the 
screen and to a log file, if specified. If an error occurs, the utility does not prompt you for 
input to correct an error or for your permission to override a safety check. 

Syntax: 

sas2flash -s 
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5.4.30 Test BIOS Version Use the Test BIOS Version command to test the current BIOS version against a version 

provided on the command line in the format M.SS.CC.DD. The SAS2Flash Utility checks 
all four parts of the version number and outputs the result of the checks through the 
return codes. 



NOTE: This command is supported only in the x86 BIOS. 



Syntax: 

sas2flash -o -testbios 6.08.00.00 

5.4.31 Test Firmware Version Use the Test Firmware Version command to test the current firmware version against a 

version provided on the command line in theformat/A/A.BB.CC.DD. The SAS2Flash Utility 
checks all four parts of the version number and outputs the result of the checks 
through the return codes. 

Syntax: 

sas2flash -o -testfw 1.11.00.00 

5.4.32 Test LinkState Use the Test Link State command to test the link state of a specific PHY on a specific 

controller against a provided value. The SAS2Flash Utility outputs the test results 
through the return codes. 

5.4.33 Test Link State All When you use the Test Link State All command, the utility does not directly test the link 

state. Instead, it lists the state of all links on the selected adapter. If a PHY does not have 
a device connected to it, its link state is Link Down. 

Syntax: 

sas2flash -o -testlsall 

The valid values for testing the link state follow. 



Table 3: Valid Values for Link State Testing 







^^^^^H Value 


0 


Link Down 


1 


1.5 Gb/s 


2 


3.0 Gb/s 


3 


6.0 Gb/s 



Syntax: 

sas2flash -o -testis 4 2 

5.4.34 Test Product ID Use the Test Product ID command to test the product ID of the current firmware against 

a product ID provided on the command line in hexadecimal format. The SAS2Flash 
Utility outputs the test results through the return codes. 

Syntax: 

sas2flash -o -testprodid 0x2713 
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5.4.35 Test Subsystem Use the Test Subsystem Identification (SSID) command to input the Subsystem Vendor 
Identification ID (ssviD) and Subsystem Device ID (SSDID), and to match them to the appropriate PCI 

information for the selected controller. The output displays any discrepancies in either 
SSVID or SSDID, or it displays a success message if both values match the selected 
controller. 

Syntax: 

sas2flash -o -testssid 1000:3020 

5.4.36 Upload BIOS Use the Upload BIOS command to upload the boot block (BIOS, UEFI, and FCODE) to a 

file. If the file already exists, the command overwrites it. The command fails if there is 
not enough free disk space to hold the block. This command is useful in manufacturing 
environments to perform a comparison after an update. 

Syntax: 

sas2flash -ubios image . rom 

5.4.37 Upload Firmware Use the Upload Firmware command to upload the current firmware image to a file. If 

the file already exists, the command overwrites it. The command fails if there is not 
enough free disk space to hold the firmware image. This command is useful in 
manufacturing environments to perform a comparison after an update. 

Syntax: 

sas2flash -ufirmware image . fw 

5.4.38 Upload Firmware Backup Use the Upload Firmware Backup command to upload the firmware backup image to a 

file. If the file already exists, the command overwrites it. The command fails if there is 
not enough free disk space to hold the firmware backup image. This command is useful 
in manufacturing environments to perform a comparison after an update. 

Syntax: 

sas2flash -o -ufwbackup image . fw 

5.4.39 Upload Flash Image Use the Upload Flash Image command to upload the complete contents of Flash to a 

file. If the file already exists, the command overwrites it. The command fails if there is 
not enough free disk space to hold the block. This uploaded image can be used as a 
master image, with some changes, to program multiple similar controllers. 

Syntax: 

sas2flash -o -uflash flash. rom 

5.4.40 Upload NVDATA Use the Upload NVDATA command to upload the current binary NVDATA image to a 

file. If the file already exists, the command overwrites it. The command fails if there is 
not enough free disk space to hold the binary NVDATA image. This command is useful 
in manufacturing environments to perform a comparison after an update. 

Syntax: 

sas2flash -o -unvdata nvdata.img 
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6.0 Performance The SAS2Flash Utility runs efficiently and does not cause unnecessary delays. Memory 
utilization can be as high as 20 MB, depending on the selected operation. 

The SAS2Flash Utility supports the following exit codes. 



Table 4: Exit Codes 



• 





^^^^^^H Code 


^^^^B Description 


0 


Success 


1 


Failure 



7.0 Operating System Some operating systems do not support all SAS2Flash Utility features, because of 

Limitations limitations in their controller interface. If an operating system does not support a 

command, the utility returns an invalid function code. 

The Windows, Linux, and Solaris operating systems do not support commands that 
require the controller to be taken offline or that require a firmware download of the 
boot loader. In addition, these operating system cannot flash any part that does not 
already have valid firmware loaded and running. 
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8.0 Sample Parameter File for This section shows the contents of a sample parameter file for the Program VPD 
Program VPD Command command. Each parameter, or group of parameters, is preceded by a descriptive 

comment. 

/Large Resource Type ID String Tag. Describe the data type. 
LR_ID_STRING_TAG = 0x82 

/Length of the ID String. Must match the length of the LR_ID_STRING 
LR_ID_STRING_LENGTH = 0x0 OIF 

;Data. The actual ID String to describe the device this VPD data represents. 
LR_ID_STRING = "PCIe2 SAS Adapter Dual -port 6Gb" 
; Large Resource Type VPD Tag 
LR_VPD_TAG = 0x90 

; Total Length of all the VPD keyword, length and data wrapped by a Large 

/Resource Type VPD Tag. 

LR_VPD_LENGTH = 0x0 04C 

;VPD Keyword. Part Number of Assembly 

VPD_KEYWORD = "PN" 

VPD_LENGTH = 0x0 7 

VPD_DATA = "45D8 02 8" 

;VPD Keyword. Engineering Data Code 

VPD_KEYWORD = "EC" 

VPD_LENGTH = 0x0 7 

VPD_DATA = " G3 7068" 

;VPD Keyword. CC - Field Service CCIN 
VPD_KEYWORD = "CC" 
VPD_LENGTH = 0x04 
VPD_DATA = "7 63A" 

;VPD Keyword. Reserved and Checksum 

VPD_KEYWORD = "RV" 

VPD_LENGTH = 0x01 

VPD_DATA = "CHECKSUM" 

; Small Resource Type End Tag 

SR END TAG = 0x7 9 
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9.0 Sample Parameter File for This section shows the contents of a sample parameter file for the Program Ethernet 
Program Ethernet Information Information command. Each parameter, or group of parameters, is preceded by a 

Command descriptive comment. 



; Flags 

EP_FLAGS = OxFF 

; Media State Flags 

EP_MEDIASTATE = OxFF 

; 48 -bit MAC address of the Ethernet Interface. 

; EP_IPV6=0 indicates static IP address are to be considered as IPv4 . 
; EP_IPV6=1 indicates static IP address are to be considered as IPv6. 
EP_IPV6 = 0 

EP_MAC_ADDRESS = 11:22:33:44:55:66 
; Static IP address 

EP_STATIC_IP_ADDRESS = 192.168.0.213 
; Subnet mask 

EP_STATIC_SUBNET_MASK = 255.255.255.0 

; Gateway address 

EP_STATIC_GATEWAY_ADDRESS = 192.168.0.1 
; DNSl Address 

EP_STATIC_DNS1_ADDRESS = 172.31.171.31 
; DNS 2 Address 

EP_STATIC_DNS2_ADDRESS = 172.31.171.16 
/Hostname (Maximum 3 2 characters) 

EP_HOSTNAME = " long_hostname_of_computer_max32_" 
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